# Troubleshooting

To add new solutions, please open a pull request, issue or contact me directly.

Sorted by appearance from installation (top) to gameplay (bottom).

#### Launcher: Game download issues

Download timeout, stuck at 0%:

 * Sep/Oct 2020 launcher bug. Download the newest version and retry

Download works but launcher freezes/crashes midway:

 * Use the custom [Update & Patch Script](updater/) as an alternative to the official launcher
 * Caused by bad error handling in `launcher.exe` and a blocked domain
 * See [Issue#28](https://notabug.org/Krock/GI-on-Linux/issues/28) for solutions

#### Launcher: Useless voiceover packs get downloaded

For slow download connections, you might not want to download everything. Steps to skip downloading unwanted voiceover/language packs:

1. Locate the file `audio_lang_*` (where `*` stands for the newest) inside your game data files
2. Remove the unwanted pack lines (except maybe `English(US)`?)
3. Save
4. Navigate to `StreamingAssets/Audio/GeneratedSoundBanks/Windows/`
5. Remove the pack directories that are no longer contained within `audio_lang_*``
6. Proceed to download the archives

#### Launcher: Failed to unzip game files

1. Check for launcher updates
2. Edit `/path/to/Genshin Impact Game/config.ini`
3. Adjust the line `game_version=X.X.X` to the currently installed version
4. Re-run the launcher to install the update

Alternatively: re-download the entire game. See [Issue#28](https://notabug.org/Krock/GI-on-Linux/issues/28) for direct links.

#### Game does not start at all

1. Check & update the game version in the official launcher
2. Apply the patches as described in `README.md`

#### Lutris: 'find.exe' cannot be found, notepad opens on start

Alternatively: `notepad.exe` opens on launch, displaying an error message.

Some Lutris Wine packages either refuse to run those applications or do not ship them in first place.
Try another package, such as Proton or stock/vanilla Wine.

For more details, see [Issue#78](https://notabug.org/Krock/GI-on-Linux/issues/78).
No longer happens since lutris-6.4 wine release.


#### Game crashes on launch

1. Ensure the patch is applied
2. Retry without kernel sync (ESYNC, FSYNC, ...)
3. Lutris: disable "Lutris Runtime" ([for reference](https://notabug.org/Krock/GI-on-Linux/issues/78#issuecomment-24727))


#### Game no longer works on Windows

 * This is intentional to avoid abuse of this project
 * If you are Dual-Booting, write a batch script to swap the game files as needed


#### StartThreadpoolIo not found in KERNEL32.dll

 * Use Wine 5.3 or newer. This function has been added recently.
 * For more details, see [Issue#12](https://notabug.org/Krock/GI-on-Linux/issues/12#issuecomment-22060).


#### Freeze when loading game data

Unknown cause. Please submit ideas to [Issue#90](https://notabug.org/Krock/GI-on-Linux/issues/90)

 * Append the `-nolog` Unity argument to the last line of `launcher.bat`
 * Try another graphics driver or setup a clean, new WINEPREFIX


#### White screen freeze when entering the door
... plus error log "*err:virtual:virtual_setup_exception stack overflow*".

Starting from version 1.2.0, this error reappears a few days after each release. It is caused by server-sent bytecode.

Workaround:

	bash "/path/to/GI-on-Linux/GAMEVER/patch_anti_logincrash.sh"


#### Crash when initially loading the world (7 symbols)

Rare occurrence related to an audio failure. Observed in Wine 5.22 and newer.

1. Restart the game
2. Check for music and button sound effects


#### In-game browser looks weird or crashes the game

 * `winetricks corefonts`
 * Ubuntu/Debian: install `ttf-mscorefonts-installer`
 * Re-install dxvk (if present)
 * Try running the game in a virtual desktop

Other font installations might work as well as long Fontconfig can use them as fallback.


#### ZFGameBrowser crash

 * Ignore and restore the game window
 * For input issues: try the virtual desktop (see below)

For more details, see [Issue#29](https://notabug.org/Krock/GI-on-Linux/issues/29).


#### Graphics bugs/issues

Check whether your GPU supports Vulkan: [unofficial list](https://vulkan.gpuinfo.org/), [Intel](https://www.intel.com/content/www/us/en/support/articles/000005524/graphics.html), [nVIDIA](https://developer.nvidia.com/vulkan-driver), [AMD](https://www.amd.com/en/technologies/vulkan#paragraph-218601)

Setup instructions:

 * Custom script:
     * Download [winetricks](https://github.com/Winetricks/winetricks/)
     * `export WINEPREFIX=/absolute/path/` (if needed)
     * `sh winetricks`
     * Install the DLL package `dxvk` (newest, or 1.7.3 for Proton 5.13)
 * Lutris: Configure -> Runner options -> Enable DXVK
 * Proton: add `cmd /c launcher.bat` to your game library.
 * PlayOnLinux: (outdated DXVK?)
     * Configure game -> Install components -> [Latest DXVK version]


#### Mouse/keyboard input issues

Easiest solution:

 * `wine explorer /desktop=anyname,1920x1080 cmd /c launcher.bat` (adjust to your resolution)
 * Try Proton: add `cmd /c launcher.bat` to your game library

Lutris:

 * Runner options -> Enable virtual desktop

Without a virtual desktop: (experimental)

 * winecfg -> Check "Automatically capture the mouse in full-screen windows"
 * regedit -> `HKEY_CURRENT_USER\Software\Wine\X11 Driver` set REG_SZ `UseTakeFocus` to `N`
      * Lutris already does this by default.

See also: search engine query `unity wine focus`


#### Alt + Mouse click not working

Cinnamon users:

 * Workaround: Disable the window move & resize feature
      * See [Linux Mint forums](https://forums.linuxmint.com/viewtopic.php?t=264172)

Xfce4 users:

 * Same solution as in the `causes view to "spin"` issue below


#### Switching between workspaces causes the view to "spin"

Change the in-game resolution setting:

1. Focus the (virtual) desktop
2. Focus the game window again
3. Change the resolution back to fullscreen

Alternative: use Proton.


### Information sources

General information:

 * [PlayOnLinux](https://www.playonlinux.com/en/app-4228.html)
